安卓开发文档翻译：打印HTML文档,Printing HTML Documents

StupidBeauty

Articles
Now reading
User manage
Category
Blind Box

Read times:2630Posted at:

- no title specified

安卓开发文档翻译：打印HTML文档,Printing HTML Documents

本课程会教妳

1. 载入一个 HTML文档
2. 创建一个打印任务

要在安卓系统中打印除简单照片之外的内容的话，就需要在打印文档中编排文本和图形内容。安卓框架提供了一种方式，可以使用HTML来编排文档内容，并且使用较少的代码来打印它。

在安卓 4.4(应用编程接口级别19) 中， WebView 类进行了更新，以支持对 HTML 内容的打印。这个类，允许妳载入一个本地 HTML资源或者从互联网上下载某个网页，创建一个打印任务，然后将它提交给安卓的打印服务。

本课程向妳展示了，如何快速地构建一个HTML 文档，以容纳要打印的文本和图形内容，然后使用 WebView 来打印它。

载入一个HTML文档

使用 WebView 来打印HTML文档，需要载入一个HTML 资源或者以字符串的形式构建一个HTML 文档。本小节说明的是，如何构建一个 HTML字符串，并且将它载入到一个 WebView 中，以便打印。

这个视图对象，一般都是用于某个活动布局中的一部分。然而，如果妳的应用程序中未使用 WebView 的话，则，妳可以创建这个类的实例，以特别用于打印目的。创建这个自定义打印视图的主要步骤如下：

1. 创建一个 WebViewClient ，让它在HTML 资源载入完毕之后启动一个打印任务。
2. 将HTML 资源载入到 WebView 对象中。

以下代码示例，演示的是，如何创建一个简单的 WebViewClient ，并且载入一个快速创建的HTML 文档：

private WebView mWebView;

private void doWebViewPrint() {

// 创建一个专门用于打印的WebView 对象

WebView webView = new WebView(getActivity());

webView.setWebViewClient(new WebViewClient() {

public boolean shouldOverrideUrlLoading(WebView view, String url) {

return false;

}

@Override

public void onPageFinished(WebView view, String url) {

Log.i(TAG, "page finished loading " + url);

createWebPrintJob(view);

mWebView = null;

}

});

// 快速生成一个HTML 文档：

String htmlDocument = "<html><body><h1>Test Content</h1><p>Testing, " +

"testing, testing...</p></body></html>";

webView.loadDataWithBaseURL(null, htmlDocument, "text/HTML", "UTF-8", null);

// 保留对该WebView 对象的一个引用，直到妳将该PrintDocumentAdapter传递到PrintManager为止

mWebView = webView;

}

注意：确保妳要在之前小节中创建的 WebViewClient 的 onPageFinished() 方法中才调用代码，以生成打印任务。如果妳不等到页面载入完毕，那么，打印输出的内容可能是不完整的，或者是空白的，或者，甚至可能完全打印失败。

注意：上面的示例代码中，保留了该 WebView 对象的一个实例，以确保，它不会在打印任务创建之前被垃圾回收。请确保在妳自己的代码中也是这样做的，否则，打印过程可能失败。

如果妳想要在页面中包含图像内容，则，将图像文件放置到妳的项目的 assets/ 目录中，并且，在 loadDataWithBaseURL() 方法的第一个参数中指定一个基准网址，正如以下示例代码中那样：

webView.loadDataWithBaseURL("file:///android_asset/images/", htmlBody,

"text/HTML", "UTF-8", null);

妳也可以载入一个网页以进行打印，具体就是将 loadDataWithBaseURL() 方法替换成 loadUrl() ，就像以下示例中那样。

// 打印一个已有的网页(记得要获取INTERNET权限！)：

webView.loadUrl("http://developer.android.com/about/index.html");

在使用 WebView 创建打印文档时，妳应当注意以下限制：

•. 妳无法向文档中添加页眉及页脚，包括页码也无法添加。
•. 对于HTML 文档，其打印选项不支持指定打印的页码范围，例如：想要打印一个10 页的HTML 文档中的第2 到4 页，这是不支持的。
•. 一个 WebView 实例，一次只能处理一个打印任务。
•.包含CSS 打印属性（例如横向模式属性）的HTML文档，是不支持的。
•. 妳无法在HTML 文档中使用 JavaScript 来触发打印过程。

注意：布局中包含的 WebView 对象，在它载入了文档之后，其内容也可以被打印。

如果妳想要创建一个更加自定义的打印输出，并且想要完全控制打印出来的页面上绘制出来的内容，那么，请阅读下一篇课程：打印自定义文档。

创建一个打印任务

在创建了 WebView 并且载入了HTML 内容之后，在打印这件事上，妳的应用程序已经快要做完它的工作了。接下来的步骤就是，访问到 PrintManager ，创建一个打印适配器，最终，创建一个打印任务。以下示例，展示了，如何完成这些步骤：

private void createWebPrintJob(WebView webView) {

// 获取到一个PrintManager 实例

PrintManager printManager = (PrintManager) getActivity()

.getSystemService(Context.PRINT_SERVICE);

// 创建一个打印适配器实例

PrintDocumentAdapter printAdapter = webView.createPrintDocumentAdapter();

// 创建一个打印任务，指定名字和适配器实例

String jobName = getString(R.string.app_name) + " Document";

PrintJob printJob = printManager.print(jobName, printAdapter,

new PrintAttributes.Builder().build());

// 保留该任务对象，以便日后检查状态

mPrintJobs.add(printJob);

}

这个示例中，保留了该 PrintJob 对象的一个实例，以让应用程序本身使用，当然，这并不是必要的动作。妳的应用程序可使用这个对象来在打印过程中跟踪打印任务的进度。这种做法，狠有用的，妳可以用这种方法来监视该打印任务的状态，以得知任务是否最终完成、是否失败，或者是否被用户取消了。不需要在妳的应用中创建一个通知项，因为，打印框架会自动为该打印任务创建一个系统级的通知项。

小米

Your opinions

Your name:

Email:Website url:Opinion content:

- no title specified

HxLauncher: Launch Android applications by voice commands